/**
 * @file mp3.h
 * @brief MP3播放功能模块的头文件
 * @details 声明了MP3文件列表和用于控制播放的函数。
 * @version 1.0
 * @date 2025-07-05
 */

#ifndef _MP3_PLAYER_H_
#define _MP3_PLAYER_H_


/**
 * @brief 外部声明：存储MP3文件路径的全局数组。
 * @details 该数组包含12个MP3文件的路径，
 * 实际定义应存在于对应的 .c 文件中。
 */
extern const char* mp3_file[12];

/**
 * @brief 在后台播放一个MP3文件。
 * @details 此函数通过调用 'mpg123' 命令行工具来播放指定的音频文件。
 * 音频会在后台播放，不会阻塞主程序的执行。
 * @param index 要播放的MP3文件在 `mp3_file` 数组中的索引 (有效范围 0-11)。
 */
void play_mp3(int index);


#endif // _MP3_H_